package com.gobang.domain.dto;

import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Positive;
import lombok.Data;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import com.fasterxml.jackson.annotation.JsonProperty;


/**
 * 取消匹配请求数据传输对象
 * 用于用户请求取消匹配时的参数传递
 *
 * @author gobang-team
 * @since 1.0.0
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class CancelMatchRequestDTO {

    /**
     * 用户ID
     * 必须为正数，用于标识请求取消匹配的用户
     */
    @NotNull(message = "用户ID不能为空")
    @Positive(message = "用户ID必须为正数")
    @JsonProperty("userId")
    private Long userId;

    /**
     * 取消原因（可选）
     * 用户取消匹配的原因，用于统计和优化匹配体验
     * 可选值：USER_CANCEL（用户主动取消）、TIMEOUT（超时取消）、ERROR（错误取消）
     */
    @JsonProperty("cancelReason")
    private String cancelReason;
} 